package com.rui.composite.main;

import com.rui.composite.model.Menu;
import com.rui.composite.model.MenuItem;
import com.rui.composite.obj.MenuComponent;

/**
 * 组合模式（Composite Pattern）
 * <p>
 * 组合模式也称为整体-部分（Part-Whole）模式，它的宗旨是通过将单个对象（叶子结点）和组合对象（树枝节点）用相同的接口进行表示。
 * <p>
 * 作用：使客户端对单个对象和组合对象保持一致的方式处理。
 * <p>
 * 组合模式主要包含三种角色：
 * 抽象根节点（Component）：定义系统各层次对象的共有方法和属性，可以预先定义一些默认行为和属性。
 * 树枝节点（Composite）：定义树枝节点的行为，存储子节点，组合树枝节点和叶子节点形成一个树形结构。
 * 叶子节点（Leaf）：叶子节点对象，其下再无分支，是系统层次遍历的最小单位。
 * <p>
 * <p>
 * 适用场景：
 * 希望客户端可以忽略组合对象与单个对象的差异时。
 * 对象层次具备整体和部分，呈树形结构（如树形菜单，操作系统目录结构，公司组织架构等）。
 * <p>
 * 优点：
 * 清楚地定义分层次的复杂对象，表示对象的全部或部分层次。
 * 让客户端忽略了层次的差异，方便对整个层次结构进行控制。
 * 简化客户端代码。
 * 符合开闭原则。
 * <p>
 * 缺点：
 * 限制类型时会较为复杂。
 * 使设计变得更加抽象。
 * <p>
 * 分类：
 * 透明组合模式
 * 透明组合模式中，抽象根节点角色中声明了所有用于管理成员对象的方法，比如在示例中MenuComponent声明了add() 、 remove() 、getChild()方法，这样做的好处是确保所有的构件类都有相同的接口。透明组合模式也是组合模式的标准形式。
 * 透明组合模式的缺点是不够安全，因为叶子对象和容器对象在本质上是有区别的，叶子对象不可能有下一个层次的对象，即不可能包含成员对象，因此为其提供 add()、remove() 等方法是没有意义的，这在编译阶段不会出错，但在运行阶段如果调用这些方法可能会出错（如果没有提供相应的错误处理代码）
 * 安全组合模式
 * 在安全组合模式中，在抽象构件角色中没有声明任何用于管理成员对象的方法，而是在树枝节点Menu类中声明并实现这些方法。安全组合模式的缺点是不够透明，因为叶子构件和容器构件具有不同的方法，且容器构件中那些用于管理成员对象的方法没有在抽象构件类中定义，因此客户端不能完全针对抽象编程，必须有区别地对待叶子构件和容器构件。
 *
 * @author ZhangRui
 * @date 2023/03/03 10:58
 **/
public class CompositeMain {


    public static void main(String[] args) {

        //创建一级菜单
        MenuComponent component = new Menu("系统管理", 1);

        MenuComponent menu1 = new Menu("用户管理", 2);
        menu1.add(new MenuItem("新增用户", 3));
        menu1.add(new MenuItem("修改用户", 3));
        menu1.add(new MenuItem("删除用户", 3));

        MenuComponent menu2 = new Menu("角色管理", 2);
        menu2.add(new MenuItem("新增角色", 3));
        menu2.add(new MenuItem("修改角色", 3));
        menu2.add(new MenuItem("删除角色", 3));
        menu2.add(new MenuItem("绑定用户", 3));

        //将二级菜单添加到一级菜单中
        component.add(menu1);
        component.add(menu2);

        //打印菜单名称(如果有子菜单一块打印)
        component.print();


        // 测试结果
        /*系统管理
            --用户管理
                ----新增用户
                ----修改用户
                ----删除用户
            --角色管理
                ----新增角色
                ----修改角色
                ----删除角色
                ----绑定用户*/

    }
}
